home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / link_addr.z / link_addr
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. lllliiiinnnnkkkk____aaaaddddddddrrrr                                                            lllliiiinnnnkkkk____aaaaddddddddrrrr
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      link_addr - elementary address specification routines for link level
  10.      access
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ssssoooocccckkkkeeeetttt....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<nnnneeeetttt////iiiiffff____ddddllll....hhhh>>>>
  16.  
  17.      vvvvooooiiiidddd lllliiiinnnnkkkk____aaaaddddddddrrrr((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****aaaaddddddddrrrr,,,, ssssttttrrrruuuucccctttt ssssoooocccckkkkaaaaddddddddrrrr____ddddllll ****ssssddddllll))));;;;
  18.  
  19.      cccchhhhaaaarrrr ****lllliiiinnnnkkkk____nnnnttttooooaaaa((((ccccoooonnnnsssstttt ssssttttrrrruuuucccctttt ssssoooocccckkkkaaaaddddddddrrrr____ddddllll ****ssssddddllll))));;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      The routine _l_i_n_k__a_d_d_r interprets character strings representing link-
  23.      level addresses, returning binary information suitable for use in system
  24.      calls.  The routine _l_i_n_k__n_t_o_a takes a link-level address and returns a
  25.      string representing some of the information present, including the link
  26.      level address itself, and the interface name or number, if present.  This
  27.      facility is experimental and is still subject to change.
  28.  
  29.      For _l_i_n_k__a_d_d_r, the string may contain an optional network interface
  30.      identifier of the form _n_a_m_e _u_n_i_t-_n_u_m_b_e_r, followed in all cases by a colon
  31.      and an interface address in the form of groups of hexadecimal digits
  32.      separated by periods.  Each group represents a byte of address; address
  33.      bytes are filled left to right from low order bytes through high order
  34.      bytes.
  35.  
  36.      Thus "ec0:8.0.9.13.d.30" represents an ethernet address to be transmitted
  37.      on the first ethernet interface.
  38.  
  39. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  40.      _l_i_n_k__n_t_o_a always returns a null terminated string.  _l_i_n_k__a_d_d_r has no
  41.      return value.
  42.  
  43. BBBBUUUUGGGGSSSS
  44.      The returned values for _l_i_n_k__n_t_o_a reside in a static memory area.
  45.  
  46.      The function _l_i_n_k__a_d_d_r should diagnose improperly formed input, and there
  47.      should be an unambiguous way to recognize this.
  48.  
  49.      If the _s_d_l__l_e_n field of the link socket address _s_d_l is 0, _l_i_n_k__n_t_o_a will
  50.      not insert a colon before the interface address bytes.  If this
  51.      translated address is given to _l_i_n_k__a_d_d_r without inserting an initial
  52.      colon, the latter will not interpret it correctly.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.